<p class="Head1"><a name="adabas"/><help:link Id="66189" xmlns:help="http://openoffice.org/2000/help">Adabas D Database</help:link></p>
<p class="Paragraph">Adabas D, Version 11, is a database that is available in <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname> under Windows, Linux and Solaris Sparc.<a name="ende"/> A slightly restricted version is supplied with <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname>. You can obtain further information on Adabas, additional help files and ordering options for higher versions from the manufacturer at http://www.adabas.com.</p>
<p class="Paragraph">The Adabas database server must be attainable if you want to work with an Adabas database. If you are not accessing an Adabas database server located on the network, but working with a stand-alone computer you first need to install the Adabas database server and start it. The Adabas database server supplied with <help:productname>%PRODUCTNAME</help:productname> can be installed by using the appropriate separate installation program.</p>
<p class="Paragraph">The Setup program for installing Adabas D automatically starts after the <help:productname>%PRODUCTNAME</help:productname> Setup program as long as you run a stand-alone installation. Read the Installation's Guide for more information on the Adabas installation</p>
</span></td></tr></table>
</help:to-be-embedded>
<p class="Head2">Properties of the <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname> version of Adabas</p>
<p class="Paragraph">Adabas D Version 11, supplied with <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname>, is restricted to a maximum size of 100 MB databases. When the database is being used in a network, a maximum of three users will be able to access the database simultaneously. Further information can be found in the License.txt file located in your Adabas directory after the installation has been completed. Adabas is available in both, the standard installation and the customized installation in the Setup program of <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname>. It is also possible to deselect the installation of Adabas in the customized setup of <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname>. Adabas should not be installed in the <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname> directory but in one directory of its own. Adabas and <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname> can be separately deinstalled if required.</p>
<p class="Paragraph">The DBROOT environment variable will be set during the installation among some other things. This variable refers to the directory where Adabas has been installed. This happens under Windows 9x through command lines in the Start file Autoexec.bat. You will therefore have to restart your computer before using Adabas for the first time.</p>
<p class="Paragraph">If the environment variable DBROOT is found at the time of installation Adabas will not be offered for installation as the setup program assumes that Adabas has already been installed.</p>
</span></td></tr></table>
<p class="Head2"/>
<p class="Paragraph">You can enter and edit your data in the database with the help of <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname> or use SQL commands to control the database. <text:s text:c="" xmlns:text="http://openoffice.org/2000/text"/>In <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname> Adabas supports the commands in accordance with the SQL92 standard.</p>
<p class="Head2">The performance values of Adabas D in <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname></p>
<p class="Paragraph"><help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname> can access an Adabas D database if the latter has a version number 11.02 or higher.</p>
<p class="Paragraph">The following values apply to the Adabas D version 11 under <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname>:</p>
<p class="Paragraph">Restricted to a max. of <text:s text:c="" xmlns:text="http://openoffice.org/2000/text"/>100 MB and 3 users per database.</p>
<p class="Paragraph">Adabas D supports the following <span class="T1">data types</span>:</p>
<p class="Paragraph">The internal filing of CHAR values is carried out up to a length of 30 in a fixed format. Larger CHAR values are always saved internally with a variable length representation. CHAR values with a length of less than 30 can also be kept in a variable length representation by entering the data type VARCHAR.</p>
<p class="Paragraph">TIME values are stored internally in the form HHMMSS. The external representation can be configured in a similar way as the the DATE values. DATE and TIME values are special CHAR values. This means that not only the date and time functions but also all functions can be used on CHAR values.</p>
<p class="Paragraph">TIMESTAMP values are always internally stored in the YYYYMMDDHHMMSSmmmuuu format. These are a combination of a DATE and a TIME value and have been enhanced with the values for milliseconds and microseconds. As well as being used as a time stamp the TIMESTAMP values can also be used for time arithmetic, as day overflows do not need to be handled by the user. TIMESTAMP values are special CHAR values. This means that they can also be used on all CHAR values and not just in date and time functions.</p>
<p class="Paragraph">For saving unformatted data (BLOBs) Adabas offers the data type LONG which can take up to 2.1 GB of data per column. Not only is CHAR columns supported but also the variants ASCII, EBCDIC and BYTE. This means that Adabas is able to manage extensive information in text, graphics or speech form in the appropriate way.</p>
</span></td></tr></table>
<p class="Paragraph">The additonal data types existing in other SQLMODEs are understood by Adabas and are mapped to the data types listed above.</p>
<p class="Head2"><help:key-word value="Creating a New Adabas Database" tag="kw66189_1" xmlns:help="http://openoffice.org/2000/help"/>Creating a New Adabas Database</p>
<p class="Paragraph">Use the <help:link Id="66186" xmlns:help="http://openoffice.org/2000/help"><span class="T1">Create New Adabas Database</span></help:link> dialog to create a new Adabas database. You can call up this dialog in the following way, for example:</p>
<ul class="L1">
<li class="">
<p class="P3">Choose <span class="T1">Tools - Data source</span> to open the <span class="T1">Administrate Data Sources</span> dialog. In the <span class="T1">Database type</span> field select the "Adabas" database type. Click the <span class="T1">New database</span> button.</p>
</li>
</ul>
<p class="Paragraph"><help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname> has already filled a lot of fields in the dialog with values so that you usually only have to enter the name of the database and the name and password of the Administrator. These three details are, however, imperative.</p>
<p class="Head2"><help:key-word value="Deleting an Adabas Database" tag="kw66189_2" xmlns:help="http://openoffice.org/2000/help"/>Deleting an Adabas Database</p>
<p class="Paragraph">If you delete the database entry in <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname>, you only delete the access to the data from <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname>. The "actual" files of the database remain intact. To really delete all the files proceed as follows:</p>
<ul class="L2">
<li class="">
<p class="P4">First, find out the name of the database. This is not necessarily the name of the entry. Open the context menu and choose <span class="T1">Properties</span>. The name of the database is in the <span class="T1">Data Source</span> field on the <span class="T1">Type</span> tab.</p>
</li>
<li class="">
<p class="P4">Determine which directories are referred to by the system variables DBCONFIG and DBWORK. <help:switch select="System" xmlns:help="http://openoffice.org/2000/help"><help:case select="WIN">Under Windows these variables are defined in the c:\Autoexec.bat file.</help:case></help:switch><help:switch select="System" xmlns:help="http://openoffice.org/2000/help"><help:case select="UNIX"> Under Unix these variables are defined in a Start script.</help:case></help:switch></p>
</li>
<li class="">
<p class="P4">Delete the three files with the database name in the $DBCONFIG$ directory. If you have named the database TEST for example, you would delete the following three files: C:\Adabas\Sql\Test.sys, Test.trs and Test.dat.</p>
</li>
<li class="">
<p class="P4">Delete a file that has the same name as the database in the directory $DBCONFIG$\Config. If you have named the database TEST for example, you would delete the file: C:\Adabas\Sql\Config\Test.</p>
</li>
<li class="">
<p class="P4">Delete an entire directory with the name of the database in the $DBWORKS$\Wrk directory. If you have named your database TEST for example, you would delete the directory C:\Adabas\Sql\Wrk\Test.</p>
</li>
<li class="">
<p class="P4">Make sure that you only delete those files or directories where their name corresponds to that of the database.</p>
</li>
</ul>
<p class="Head2">Starting and Closing an Adabas Database</p>
<p class="Paragraph">completely shuts down the database</p>
<p class="Head2">Error Messages in an Adabas Database</p>
<p class="Paragraph">Here are the error messages that might occur while working with Adabas D.</p>
<p class="Head3">The database cannot be shut down / restarted as a user is still connected to it.</p>
<p class="Paragraph">Close any other open tasks that show the database contents. With multi-user systems, you should prompt all users to leave the database. If that does not help either, you need to close <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname> and restart.</p>
<p class="Head3">Client unable to establish connection; -813 SERVERDB MUST BE RESTARTED</p>
<p class="Paragraph">This error occurs if you try to access an Adabas D database which hasn't been started. Normally, an Adabas D database will be started automatically when you access it with <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname> for the first time. The Control user in the Properties of the database must be however entered. The Control user will be defined when setting up the database.</p>
<p class="Head3">Client unable to establish connection; -8022 USER ALREADY CONNECTED</p>
<p class="Paragraph">This error occurs if you try to access an Adabas D database, but the same user is already linked to the database.</p>
<p class="Head3">Errors occurring when writing the data in the database</p>
<p class="Paragraph">"The database properties cannot be modified as the database is still in use". <text:s text:c="" xmlns:text="http://openoffice.org/2000/text"/>If an error message like this appears, you must close and restart <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname>. Then immediately change the database properties.</p>
<p class="Head2"><a name="remote"/>Adabas Server in the Network</p>
<p class="Paragraph">The Adabas Server runs on a network computer in the shared database applications in a network, whereas only the Adabas Client runs on the Workstations.</p>
<p class="Head3">Remote Connection</p>
<p class="Paragraph">To enable a Remote connection, the support program xtcpupd.exe has to be run on both computers (Client and Server). The xtcpupd.exe program only exists under Windows.</p>
<p class="Paragraph">The program x_server from the <help:switch select="System" xmlns:help="http://openoffice.org/2000/help"><help:case select="UNIX">adabas\bin</help:case><help:default>Adabas\bin</help:default></help:switch> directory has to be started on the server (all platforms).</p>
<p class="Paragraph">Register a remote connection as a new Adabas database. In the <span class="T1">Data source</span> text box, enter the name of the external computer, a colon and the name of the external database, e.g. computername: database. On the <span class="T1">Adabas D</span> tab page enter user name and password and click OK. Now you can use the remote database.</p>
<p class="Paragraph">If you create a new database on a Remote Server, there are two possibilities:</p>
<p class="Paragraph">You could install a <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname> on the Remote Server and create the new database locally or,</p>
<p class="Paragraph">use the Adabas Tools for creating a new Adabas database on the Server.</p>
<p class="Paragraph">It is not possible to create the new database from a <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname> Client.</p>
